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e Previous release notes 


Overview 





LiveCode 9.0 enables access to libraries and platform APIs written in many other languages 
thanks to the community-funded ‘Infinite LiveCode' project. 


This includes a greatly improved LiveCode Builder virtual machine. 


LiveCode 9.0 contains many additional improvements to support LiveCode app developers, 
including: 


e Anew "spinner" widget 
e OAuth2 authentication library for use with web APIs (e.g. Facebook, Google and GitHub) 
e Acommand argument parser library for building command-line standalones 


e Updates and performance improvements for existing widgets 


Known Issues 





e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording. 
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Standalone Building 


The standalone builder has always needed to close the stacks it builds for reasons pretty deeply 
ingrained in the code. However this causes a few problems, for example: 


e values in script locals become empty 
e behaviors are broken when the parent script is on / in a stack which closes 


As an attempt to improve this situation, the code that locks messages when closing and opening 
stacks for standalone builds has been removed. This means that where previously mainstacks 
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would not receive any of the (pre)open* and close* messages (e.g. preOpenStack, 
openStack, openCard, closeStack etc) during standalone build, they now do. 


If this causes problems for your stack, you can exit from the handler if standalone building is in 
progress: 


on closeStack 
if the environment is "development" and \ 
there 1s a stack "revStandaloneProgress" and \ 
the mode of stack "revStandaloneProgress" > @ then 
exit closeStack 
end if 
end closeStack 


LiveCode Builder 


Ex ponentiation operator precedence 


Prior to this release, exponentiation had lower precedence that unary minus. In order to write 
code that operates as expected in both this release and previous releases, please use 
parentheses where appropriate. 


Using Ic-compile tool in LiveCode 9: 
-1%2 = -1 


Using Ic-compile tool in LiveCode 8: 


-1%2 = 1 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows 7 (both 32-bit and 64-bit) 
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e Windows Server 2008 
e Windows 8.x (Desktop) 
e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [Server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


°0 GTK/GDK 2.24 or later 

o Pango with Xft support 

0 esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

°o Icms (optional, required for color profile support in images) 
° gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 


The Mac engine supports: 


e 10.9.x (Mavericks) 
e 10.10.x (Yosemite) 
e 10.11.x (El Capitan) 
e 10.12.x (Sierra) 

e 10.13.x (High Sierra) 
e 10.14.x (Mojave) 
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IOS 


IOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 

e Xcode 8.2 on MacOS X 10.11 

e Xcode 9.2 on MacOS 10.12 (Note: You need to upgrade to 10.12.6) 
e Xcode 10.0 on MacOS 10.13 (Note: You need to upgrade to 10.13.4) 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
Simulators. For instance, on MacOS 10.12 (Sierra), you can add Xcode 6.2 in the Mobile Support 
preferences, to let you test your stack on the /OS Simulator 8.2. 


We currently support deployment for the following versions of iOS: 


e 8.2 [simulator] 
e 9.2 

e 10.2 

e 11.2 

e 12.0 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv7 or ARMV8 processors. It will run on the following 
versions of Android: 


e 4.1-4.3 Jelly Bean) 
e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 
e 6.0 (Marshmallow) 
e 7.x (Nougat) 

e 8.x (Oreo) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the ‘Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 
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Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTMLS5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Setup 





Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS xX, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

Windows (eee data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/lLivecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 
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On Mac OS xX, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
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The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 


Suess for the current user only. 

feslceasaierteun Place a shortcut on the Desktop (Windows-only) 

-startmenu Place shortcuts in the Start Menu (Windows-only) 

-Location The folder to install into. If not specified, the LOCATION defaults to those 

LOCATION described in the "Installation" section above. 

Silay (lee als The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
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command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<Livecode> activate -file LICENSEFILE -passphrase SECRET 


where <livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 


given SECRET passphrase, and installs a license file for all users of the computer. Manual 


activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <livecode> activate -file LICENSE -passphrase SECRET 
Start /wait <livecode> deactivate 


On Mac OS X, you need to do: 


<Livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<Livecode>/Contents/MacOS/LiveCode deactivate 
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Specific engine bug fixes (9.0.2-rc-2) 


21685 Redraw screen correctly when hiding the keyboard on Android 
21706 Ensure location services work when the standalone is built with the iOS 12 SDK 
21707 Ensure DataGrids with decimal keys can scroll 


Specific engine bug fixes (9.0.2-rc-1) 
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11794 


15167 
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19670 
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20193 
20283 
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20640 
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20943 
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21436 
21453 
21458 
21468 
21469 
21474 
21476 
21488 
21491 
21494 
21500 
Z1527 
21529 
21552 
21556 


21572 


21582 
21592 
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Clarify how pageRect works 

Ensure right-clicking on a grouped radio button does not change the hilite of the 
group 

Added note in the documentation for copy that copy operations that result in an 
object being put on the clipboard are not supported on mobile 


Fix crash on iOS when calling hide this stack with visual .. and the stack's 


name is with 

Allow & and other special characters in the android standalone label 

Correct the loc of option menus and pulldown menus triggered by a popup stack 
Fix return key event handling in fields on Android 

Add support for symbolic links in Mac/Linux standalone applications 

Add UDP into summary 

Fix effective working screenrect on Android when status bar is hidden 

Fixed bug causing minWidth & minHeight to not work on HiDPI Screens in Win32 
Fix import snapshot from rect causing other applications to lose focus on Windows 
Updated broken links in encrypt using rsa dictionary entry 

MouseEnter and MouseLeave infinite loop trap - docs update 

Updated orientation docs for iPhone X support 

Update launch URL command note for Android. 

Fixed broken links in "URL scheme" entry 

Added explicit RegEx escape character use examples 

Fixed typo in the print dictionary entry 

Fixed bug in resolveAlias on Win32 

Added systems requirement note to revOpenDatabase 

Updated Visual Effects and Unlock Screen docs 

Added alphabetic to the list of keyboard types in the mobileSetKeyboardType entry 
Clarified the behaviour of repeat with. 

Fix crash when calling 'open process path/to/app/bundle' 

Added "the number of elements of array" to the syntax in the entry for the number. 
Include .framework folders in iOS extension code folders 

Ensure iOS apps with embedded frameworks are correctly signed 

Fix unresponsive stack after drag and drop 

Ensure "the extents of tArray" returns empty if the keys of tArray are not integers 
Fix automatic architecture detection on some Linux systems 

Ensure pageRanges and pageHeights return correct results 

Correct missing text issue in the Round function dictionary entry. 

Fix crash when ungrouping a group before calling quit 

Include iPadPro splash image in plist file 

Fixed typo and incomplete example in Release Notes 

Prevent accidental deletion of a file when building a standalone 

Fixed missing text issue in the libraryStack dictionary entry 


Added list of blend modes to CanvasPropertyBlendMode and 
EffectPropertyBlendMode 


Fix crash and stack corruption when opening a stack that has a colorswatch widget 
Corrected several typos in the revOpenDatabase dictionary entry. 
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Android API 26: allow opening local files with JavaScript on Android Browser 

Fix application lockup when invoking a handler from the browser widget on iOS 12 
Fix crash sending touch events to a deleted stack 

Fix failure to load HTML5 standalones when mainstack is greater than 1MB 

Ensure stack vScroll due to a menubar on Mac is handled correctly when opening a 
card in an existing window 

Fix rendering issues in Motif appearance (default for iOS, Android and HTML5) when a 
button is disabled and has a non-zero blendlevel 

Fix display update issues on iOS 12 when not using accelerated rendering 

Updated beepSound dictionary entry 

Dictionary error: description of exp1 

Fix crash on iOS when changing cards and acceleratedRendering is true 

Provide an example of using ODBC with a fileDSN on Windows 

Fix crash when setting the scrollbar to false while scrolling 

Clarified the behaviour of the sheet command. 

Fix exception thrown when calling revBrowserPrint 

Ensure an error is thrown if no Map API key is specified 

Disable iOS 11 native scroller content inset adjustment behavior 

Ensure start and end dates are respected on mobilePickDate on Android 
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Specific IDE bug fixes (9.0.2-rc-1) 


14079 
17683 
21245 


21418 


21430 
21528 
21500 
21585 


Ensure subscripts and superscripts can be set more than once 

Ensure Start Center stays open when a Plugin opens on startup 

SE indent errors with inline block comments and line continuation 

Ensure arrays with comma in the key name are displayed correctly in the variable 
viewer window 

Ensure arrowKeys work correctly when editing a control's name in the Project Browser 
Ensure graphics can be reshaped more than once from the Object menu 

Make button "show grid" toggle 

Make height of sample graphics in PlI-> Effects stable 
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Specific extension bug fixes (9.0.2-rc-1) 


21428 


Allow specifying the min and max version number in qrCreate 
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21503 Prevent accidental value removal on key addition 
21567 Prevent error when hilitedElement set to empty 
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Specific engine bug fixes (9.0.2-rc-1) 


21648 Updated example in cameraControlCreate dictionary entry 
21661 Added edition information to cameraControl* dictionary entries 
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Specific extension bug fixes (9.0.2-rc-1) 


Improve AWSS3GetBucket documentation to clarify results when only a single object 
is returned 


21402 Fix AWSS3PutBucket for regions other than us-east-1 

21419 Remove pParameters param from AWSS3DeleteObject 

21421 Fix signing of AWSS3GetService 

21429 Fix signing when multiple parameters are included in a query string 


21599 


LiveCode Business extension changes 





Specific extension bug fixes (9.0.2-rc-1) 


20942 Improve remove debugger script cache clearing between debug sessions 
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Specific builder bug fixes (9.0.2-rc-1) 


21507 Fix incorrect parameter order in com.livecode.math atan2 function 
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